home *** CD-ROM | disk | FTP | other *** search
/ Mac Mania 4 / MacMania 4.toast / / Tools&Utilities / Aaron 1.1.3 (Fat) folder / Aaron 1.1.3 (Fat) / Aaron Docs < prev    next >
Text File  |  1995-09-30  |  23KB  |  244 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8. Aaron version 1.1.3, October 2, 1995
  9. Copyright © 1991–1995 Gregory D. Landweber and ISYS Development Corp., ALL RIGHTS RESERVED
  10. Brought to you by the authors of Greg's Buttons, Greg's Browser, and DoubleScroll.
  11.  
  12. greg@math.harvard.edu (Greg Landweber) — for everything except the windows, scroll bars, zoom rects
  13. ISYSDev@aol.com (Ed Voas) — regarding the windows, scroll bars, and spinning zoom rects.
  14.  
  15. (We do not provide snail-mail or telephone support for Aaron. The Kagi Shareware address and fax number are for registrations only, not support. Most importantly, do not call the Harvard Math Department. If you want to talk, send your 'phone number in an e-mail message and we will call you.)
  16.  
  17. Please note that we are each getting several dozen e-mail messages a day regarding Aaron. While we do read every message when it comes in, you may not get a prompt response, particularly if you ask a question that is answered here. Please do NOT include screen shots or long lists of all your system extensions. These take up a great deal of space and are rarely useful. If we need such information, we will ask for it.
  18.  
  19. Please do NOT distribute modified versions of Aaron. It is difficult enough to support the versions that we release, and it becomes a nightmare if we have to support versions that we have never seen. Also, please distribute Aaron as a complete package, including Register, Espi Sans 10, and this documentation file.
  20.  
  21. Aaron is a small extension that transforms your Mac's user experience to resemble the Copland 3-D style as shown in recent issues of MacWeek, MacUser, and MacWorld magazines. To use it, just drop it in your Extensions folder, or drop it on your System (MacOS) folder and let the Finder put it where it belongs. When you restart, you will see the changes listed below. To temporarily disable Aaron, hold down the mouse button while it loads at startup.
  22.  
  23. Aaron is a “Fat Binary” containing both 680x0 and PowerPC native code for optimum performance on both Macs and PowerMacs. In other words, Aaron is Accelerated for Power Macintosh. Aaron requires a 68020 or better, so in particular it won't work on a Mac Plus. Sorry.
  24.  
  25. Shareware registration info
  26.  
  27. Aaron is shareware; it is NOT free. If you use Aaron, you should pay a $10 registration fee. Registrations for Aaron ar handled by the Kagi Shareware service run by Kee Nethery (shareware@kagi.com). In addition to cash in various currencies and US dollar checks drawn on US banks, Kagi Shareware also accepts credit card registrations by mail, fax, or e-mail (your card number is scrambled). For organizations, they handle invoices and site licenses, too. For more information, run the enclosed “Register” program. It creates a customized registration form and tells you where to send it.
  28.  
  29. After you register, you will be sent a trick to disable the Annoying Shareware Message™ that appears at startup. Because of this, it is vital that you give your e-mail address or check the Paper Receipt box (for $1 extra) in Register.
  30.  
  31. Please note that we do not send out updates of Aaron or notification of new versions. A mailing (or e-mailing) list of that size would be unmanageable, and we want to spend our spare time coding, not stuffing envelopes. However, we do make updates available on all online service and internet Mac software archives. Once you register, you remain registered for all future shareware versions of Aaron, even if we add zillions of feature and raise the price.
  32.  
  33. List of features
  34.  
  35. •    Substitutes Espi Sans Bold 10 for Chicago 12 as the system font. If you are using Greg's Buttons, then this feature disables itself. In that case, you need to switch on the Substitute System Font feature in Greg's Buttons and select Espi Sans Bold 10 yourself.
  36.  
  37. •    The menu bar and menus use a light gray background and a dark blue highlight color. In addition, the menu bar takes on a subtle 3D effect.
  38.  
  39. •    Replaces the standard push buttons, check boxes, and radio buttons with Copland-style 3D shaded ones.
  40.  
  41. •    The header information in Finder windows (the # items... and Name, Size, Kind,... lines at the top of the window) is drawn using a gray background and a subtle 3D effect.
  42.  
  43. •    Automatically installs 3D Copland-style folder icons. There are many versions of these icons floating around in cyberspace. The ones included with Aaron have been tweaked to match the various Copland screen shots as closely as possible. Aaron does not change your system file, so your icons will revert to normal if you disable Aaron.
  44.  
  45. •    Windows and scroll bars are now drawn using the Copland 3D style as seen in the various Copland screen shots. These windows have a WindowShade widget at the top right of the title bar. Clicking on it collapses the window to just its title bar.
  46.  
  47. •    Transforms the Finder progress boxes to look like the Copland screen shots. This also partially affects some progress bars in other applications. It looks so cool that you will be copying and trashing files just to see the progress box!
  48.  
  49. •    Provides a new Copland-style pop-up menu button. This affects only those programs that take advantage of the System 7 pop-up menu routines, so please do not complain if the pop-ups in your favorite application or control panel remain unchanged.
  50.  
  51. •    Those little disclosure triangles in Finder list views take on a slight 3D effect.
  52.  
  53. •    Adds spinning zoom rects to the Finder. These require a 68040 or better to enable themselves, else you'll just get plain ol' zoom rects.
  54.  
  55. The Espy Sans font family
  56.  
  57. Espy is a new font designed by Apple's Human Interface people for easy readability on computer screens. Aaron installs Espi Sans Bold 10 as you system font in place of the usual Chicago 12 font, and the font Espi Sans 10 is included with the Aaron package. You should try selecting Espi Sans 10 as your Finder font using the Views control panel. Some people prefer the Espy Sans 9 size for Finder views, but all the Copland screen shots use the 10 point size.
  58.  
  59. You can get the entire Espy font family as part of the eWorld software. Alternatively, these fonts live inside the Apple Guide extension, so you can make a copy of your Apple Guide extension, change its file type to FFIL and its creator to DMOV, and then open it like a suitcase to extract all the Espy fonts. I am told that this font is also used by the Newton and comes with the Newton Toolkit as well as the Newton Toolkit Demo (part of “Programming for the Newton“ by McKeehan and Rhodes). Please note that since Espy was designed to be a screen font, there are not TrueType or PostScript versions for use with printers.
  60.  
  61. Here are some quotes about Aaron
  62.  
  63. “I don't think everyone realizes the power of a ‘change of scenery’ to alter your mood or outlook on life...it makes you literally feel different.” — Kevin Lesniewicz
  64.  
  65. “I never thought I'd get that excited about a button.” — Ed Voas
  66.  
  67. “What can I say? — it works.” — Leo Breebaart
  68.  
  69. “...Aaron is awesome! I never dreamed that a few subtle changes in the Mac's 'User Experience' could get me so excited about Macintosh all over again!” — Dave Mah Ming
  70.  
  71. Known problems
  72.  
  73. •    There appears to be an anomaly with the windowshade feature on 680x0-based Macs. If you collapse a large window completely covering a smaller one, the smaller one may fail to redraw its contents.
  74.  
  75. •    If you are running Greg's Buttons, the system font substitution feature in Aaron disables itself. If you want the Espi Sans Bold 10 font, you need to switch on the Substitute System Font feature in Greg's Buttons and select Espi Sans Bold 10 yourself. This is a feature, not a bug. Both Aaron and Greg's Buttons have the same font substitution code, but in addition Greg's Buttons gives you an interface to switch it on and off and select the font.
  76.  
  77. •    In ClarisWorks and ClarisDraw, the menus highlight in black instead of blue. If you are using Now Menus, you will not experience this problem. Please note that this is not a symptom of a more significant conflict, so there is no reason to avoid using Aaron and ClarisWorks/ClarisDraw together (unless you really hate black menu highlights).
  78.  
  79. •    Some menu bar additions, such as the Now Contact and Reminder icons and various menu bar clocks, erase the 3D gray tinges on the menu bar. Fixing this would be more trouble than it is worth.
  80.  
  81. •    When Aaron is running, menus in Canvas become unreadable. This is a long standing bug in Canvas that conflicts with substitute system fonts.
  82.  
  83. •    If your monitor is set for 256 Colors, then the indicators for DiskLight, In Use, or AppleShare in your menu bar are drawn in yellow and do not show up well against the light gray background. This is a problem with the system's color inverse routines, and there is nothing I can do.
  84.  
  85. •    If you are using or have ever used another program to change your menu colors (such as Aurora or Kolor), then your menu color settings may override Aaron's. This can happen even if you have set your menus back to black and white since those utilities may have left a rogue color resource (specifying black and white as the colors) in your System file. Aurora 3.3 will remove this color resource if you tell it to de-install. Otherwise, to get rid of this, you can either remove all “mctb” resources from your System file with ResEdit or perform a fresh install.
  86.  
  87. •    If you use Greg's Buttons with Aaron, the menu colors in Greg's Buttons will override those in Aaron. If you want to use Aaron's menu colors (as well as its blue highlight), you must turn off menu colorization in Greg's Buttons.
  88.  
  89. •    Aaron must load after the CE Toolbox extension. That is why it is named ~Aaron.
  90.  
  91. •    FrameMaker may complain about a font error when startup up. This is due to FrameMaker's overzealous font checking. There really is no problem, and FrameMaker will continue to work normally.
  92.  
  93. Finder Window Title Bar Icon Caveats
  94.  
  95. •    If you change the icon while the window is open, it will not get the changes until the window is closed and reopened.
  96. •    Since I only get icons when I need them, if you do change the icon, and then say, drag the window to another monitor with a different depth, which requires a different version of the icon from the icon suite, you may end up with a weird looking icon because you may have the mask from the old icon with the new icon on top of it. Yuck.
  97. •    The trash does not show full in the title bar, for now it's always the empty icon. Deal with it, pink boy!
  98. •    Desktop Printers show an icon with an "X" through it. This is not a simple problem to fix.
  99.  
  100. Needless to say, there's room for improvement. Please do NOT e-mail these problems to me (Ed).
  101.  
  102. Changes in version 1.1.3
  103.  
  104. •    The popup menus in the PowerBook and Auto Power On/Off control panels now work correctly.
  105. •    Fixed a conflict with AppleScript that could cause crashes on Power Macs.
  106. •    The Encoding popup menus in Netscape now list encodings instead of fonts.
  107. •    The PopUpFolder submenus now work correctly in the open/save box folder title popup menu.
  108. •    The rotating zoom rectangles should work with System 7.5 Update 2.0.
  109.  
  110. Changes in version 1.1.2
  111.  
  112. •    Fixed the Type 11 errors and related crashes when dragging the scroll bar thumb in certain applications, such as Word, Quicken, and Alpha.
  113. •    The spinning zoomrect effect is faster and much less pronounced.
  114. •    The PlainTalk speech recognition window should appear correctly now.
  115. •    The Speed Dial popup menu in MegaPhone now works correctly. The popup menus now support hierarchical submenus (personally, I don't think popups should have submenus).
  116. •    The Categories popup menu in Claris Organizer now shows the correct colors. The popup menus now support color menu items.
  117. •    The Speed Copy (Speed Doubler) progress boxes are now Copland-ized.
  118. •    Resizing the Now Menus control panel should no longer crash (we really mean it this time).
  119. •    Improved the trash can icon slightly.
  120. •    The disclosure triangles in ClarisWorks 4 are no longer switched.
  121. •    Fixed a conflict with the Code Warrior 7 version of PowerPlant Constructor.
  122. •    If Greg's Buttons is running, Aaron disables its system font substitution feature.
  123.  
  124. Changes in version 1.1.1
  125.  
  126. •    WindowShade widget should now function on systems earlier than 7.5
  127. •    Fixed potential 'Unimplemented Trap' error on startup when running other extensions such as SpeedyFinder7.
  128.  
  129. Changes in version 1.1
  130.  
  131. •    Aaron and WindowShade no longer work well together. The WindowShade widget in the title bar works just dandy, though. This was done to fix the problem with Stuffit (mentioned below). This was also done in anticipation of a future addition to Aaron.
  132. •    Added Copland-style floating windows.
  133. •    Added spinning zoom rects in the Finder. These are Finder version dependent. If they do not work for you please let me (Ed) know which version of the Finder you are using and I'll adjust it to work properly for you. Also, you can tweak these zoomrects via the 'WPrf' resource. Increasing the number of steps will improve the effect, but they will be slower.
  134. •    Photoshop's Curves dialog box is no longer transparent.
  135. •    More's window will no longer roll up and and cause scroll bars to be drawn on the desktop when doing a File:Open.
  136. •    Wünderbar now works correctly with Aaron. No more clicks going 'thru' the window.
  137. •    Fixed a second conflict with MicroPhone.
  138. •    Fixed a conflict with StuffIt that caused crashes when collapsing windows with the WindowShade widget.
  139. •    Fixed a conflict with MacUSA/MacGlobe
  140. •    Trying to resize the window for the Now Menus control panel should no longer crash.
  141. •    Fixed a conflict with the Text control panel.
  142. •    Fixed once and for all the system bug that could cause gibberish in the menu bar or crashes when launching applications. So, you no longer need to mess with the "mctb" resource (in fact, it is no longer there, although that is not related to the fix). Many thanks to Steve Kiene for tracking down the cause of this problem and suggesting a fix. There are actually two fixes in place to make sure this problem never reoccurs, so if you do experience a crash when launching an application, it is probably some other unrelated bug.
  143. •    Fixed the problem where the system font would occasionally switch to Espi Sans Bold 10 on systems that don't use Chicago as the system font (such as KanjiTalk). Again, we have two fixes for this problem: one to avoid the thing that was triggering it, and another to substitute the correct font back in if it were to be triggered in some other way.
  144. •    Fixed a memory leak that could cause the Finder to run out of memory.
  145. •    Eliminated the slight delay when opening some windows. Window drawing should be significantly faster.
  146. •    The Script Editor's grow box works properly now.
  147. •    The ghost thumb is fully functional. It should no longer conflict with anything, not even Scrolling (though with Scrolling, you will not get the ghosting). This feature is now turned on by default.
  148. •    Aaron now uses the correct Finder window title bar icon for volumes such as CD-ROMs, file servers, or the System 7.5 RAM Disk. It still doesn't get icons from the disk drivers yet.
  149. •    Aaron now recognizes the System Folder, Extensions, Control Panels, etc. on volumes other than the startup disk.
  150. •    Popup menus near the bottom of the screen pop up from the button instead of down.
  151. •    The folder popup menu in the Open and Save dialog boxes no longer duplicates the first item.
  152. •    Aaron no longer attempts to draw 3D progress bars in America Online, eWorld, or PhotoShop.
  153. •    ClarisWorks' color palettes no longer show the progress bar effect in the gray and blue wells.
  154. •    The default button outline no longer leaves stray pixels around the corners if you are using Greg's Buttons.
  155. •    Aaron does not draw its 3D menu bar tinges if you colorize your menus with some other utility.
  156. •    Eliminated the rogue vertical line on the right side of the progress bar in Anarchie.
  157. •    The push buttons now have white titles when pushed.
  158. •    Tweaked the scroll bars slightly.
  159. •    Zooming a windowshaded window should no longer cause part of the desktop to poke through the window.
  160. •    Improved behavior on black and white monitors.
  161. •    The popup routines should now work with MacApp (they now store the last selected menuID and item in the private dataHandle structure where MacApp expects to find them).
  162.  
  163. Changes in version 1.0
  164.  
  165. •    Added Copland-style 3D default button frames in dialog boxes.
  166. •    Fixed a conflict with QuickDraw GX that would cause crashes in the Print and Page Setup dialog boxes.
  167. •    Fixed the conflict with MicroPhone.
  168. •    Fixed a bug that would cause Eudora to hang/crash when opening a help window.
  169. •    Fixed a bug that could cause the system font to occasionally revert back to Chicago 12.
  170. •    Aaron now works correctly non-Roman scripts, such as Kanji, Hebrew, or Greek (but not Icelandic, I'm afraid). It specifically checks for Chicago 12 instead of blindly replacing the system font with Espi Sans Bold 10.
  171. •    The new 3D progress bar now appears in the Copy dialog box on German systems.
  172. •    Fixed a bug that could cause “Find File” to crash when you click in a pop-up menu.
  173. •    Expanded modal dialog boxes a few pixels. This gives Now SuperBoomerang (and Norton Directory Assistance?) enough room to display its menus in the Open and Save boxes without overlapping the window border.
  174. •    Command clicking in the title bar of inactive windows to move them now works again.
  175. •    Fixed a problem with the grow box in the Launcher window.
  176. •    Slightly modified the check boxes, radio buttons, window widgets, and scroll bar arrows.
  177. •    The pop-up menus now support icons.
  178. •    Aaron now supports color titles for radio buttons, check boxes, and push buttons.
  179. •    The buttons now correctly handle “254-highlighting” (an obscure technical thing).
  180. •    The windows now draw better in 16 colors.
  181. •    Aaron now uses the Greg's Buttons dialog box color for Finder progress boxes.
  182.  
  183. Changes in version 1.0b5
  184.  
  185. New Features/Improvements
  186. •    Hacked the Finder progress boxes to look like the Copland screen shots.
  187. •    Added Copland-style disclosure triangles in Finder list views.
  188. •    Added Copland-style pop-up menu controls.
  189. •    Added ‘ghosting’ effect to the scroll bar thumb when dragged. This feature conflicts with the Scrolling control panel, and it does not work correctly on some Macs. In order to use the ghost thumb, you must switch it on by editing the “SPrf” resource in ResEdit.
  190. •    Finder window title bars should now be getting the correct icon. It now pays attention to custom icons and labels.
  191. •    The windows are now pixel for pixel identical to the Copland screen shots, except as noted below.
  192. •    Added the window drop shadow. I don't know if I like it, but it is faithful to the actual. The lower left portion of the shadow does not go all the way to the edge of the window like in the screen shots. Sorry.
  193. •    Added another option in the “WPrf” resource for turning icons in Finder window title bars on or off. The icons can slow you down a little. If you have a fast machine, I would not worry about it.
  194. •    Made the radio buttons smoother, lightened the blue menu highlight color, and improved the 3D menu bar.
  195.  
  196. Bug Fixes
  197. •    Eliminated the rogue black lines that would appear when using ClarisWorks.
  198. •    The New Folder button now draws correctly when highlighted on black and white monitors.
  199. •    Fixed conflict with Folder Icon Maker where Aaron's folder icons would override custom folder icon files.
  200. •    Desktop printers windows no longer have a gray header.
  201. •    Fixed a bug that could corrupt the trash can icon.
  202. •    Fixed problem with buttons in Quark.
  203. •    Fixed problem with BBEdit that would turn the text gray after a paste operation.
  204. •    The “WPrf” resource now has a template that ResEdit can understand.
  205. •    Fixed problem where moving the scroll bar thumb to the top/left of the scroll bar would cause it to jump to the end.
  206. •    Fixed compatibility problem with the Scrolling cdev and ZTerm.
  207. •    Fixed problem where closing a windowshaded window would cause a weird desktop update.
  208. •    Changed grow box drawing behavior to only draw when called upon. This fixes the problem where the Chooser and Get Info boxes had grow boxes, but introduces another: occasionally Finder windows will not have a grow box when initially drawn. This is because the Finder has not told the WDEF to draw any grow boxes yet. Once the window becomes active, everything is normal from that point on.
  209. •    Clicking the windowshade button no longer causes ProTERM to quit.
  210. •    Wünderbar now works wünderbar. You *may* notice a slight irregularity when the window is rolled up, though.
  211. •    You can no longer move the window by clicking in the lower right edge of the window. That land has been taken over by the evil yet ever-flexible Grow Box Empire! So no more dragging when you meant to resize.
  212. •    Window titles now draw properly when in Stuffit Lite (and probably Deluxe as well).
  213. •    Window title embossing now uses a slightly darker gray, so it is not so blatant.
  214.  
  215. Changes in version 1.0b4
  216.  
  217. •    Added the WindowShade widget to the top right of the title bar.
  218. •    Windows now roll up properly when using WindowShade (no pixels left hanging off the bottom).
  219. •    Added a 'WPrf' resource to allow disabling of window title embossing, for you purists.
  220. •    Fixed problem where clicking in the grow portion of an inactive window would grow it when in fact it should have merely activated it.
  221. •    You can no longer resize a rolled up window. That was not good.
  222. •    Changed the trash can icon yet again.
  223. •    Changed the Aaron extension icon slightly.
  224. •    Aaron now draws the button frame correctly for selected push buttons on black and white monitors.
  225.  
  226. Changes in version 1.0b3 (MacHack)
  227.  
  228. •    Fixed a bug that would occasionally substitute other controls (such as sliders) for buttons.
  229. •    Fixed a bug at startup that EvenBetterBusError (EBBE) caught.
  230. •    Fixed a bug that could prevent Aaron from changing the System font to Espi Sans Bold 10.
  231. •    Aaron now lets application-specific WDEFs override its window routines.
  232.  
  233. Changes in version 1.0b2
  234.  
  235. •    Added Copland-style windows and scroll bars, courtesy of Ed Voas.
  236. •    The empty and full trash can icons now use a gray shadow instead of a black one.
  237. •    Aaron no longer draws the white highlight at the top of the screen if the menu bar is hidden.
  238. •    Aaron now has an extension icon which it draws at startup.
  239. •    Changed the name to ~Aaron so that it loads after CE Toolbox.
  240. •    Aaron can now coexist with Greg's Buttons. The settings in Greg's Buttons override Aaron.
  241.  
  242. Disclaimer
  243.  
  244. The authors, Gregory D. Landweber and Edward Voas, make no warranties, either express or implied, regarding the fitness of “Aaron” for any particular purpose. Use “Aaron” at your own risk. The authors claim no liability for data loss or any other problems caused directly or indirectly by “Aaron”.